Skip to content

doc: add test reporter event lifecycle diagram#63780

Open
Han5991 wants to merge 1 commit into
nodejs:mainfrom
Han5991:doc/test-reporter-events-lifecycle
Open

doc: add test reporter event lifecycle diagram#63780
Han5991 wants to merge 1 commit into
nodejs:mainfrom
Han5991:doc/test-reporter-events-lifecycle

Conversation

@Han5991
Copy link
Copy Markdown
Contributor

@Han5991 Han5991 commented Jun 7, 2026

Adds an "Event lifecycle" section under Class: TestsStream with an ASCII diagram showing how reporter events relate: declaration-order events vs their execution-order twins (test:dequeue / test:complete), the leaf vs suite flow, and the run-level finale.

image image

Fixes: #51908

Document the lifecycle of node:test reporter events under
Class: TestsStream, with an ASCII diagram that distinguishes
declaration-order events from their execution-order twins
(test:dequeue/test:complete), the leaf vs suite flow, and the
run-level finale.

Fixes: nodejs#51908
Signed-off-by: sangwook <rewq5991@gmail.com>
@nodejs-github-bot
Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/test_runner

@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to the documentations. test_runner Issues and PRs related to the test runner subsystem. labels Jun 7, 2026
Comment thread doc/api/test.md
* `'test:stdout'` and `'test:stderr'` are emitted only when the [`--test`][]
flag is used, and are not guaranteed to follow declaration order.
* `'test:interrupted'` is emitted if the run is interrupted by a `SIGINT`
signal (for example, <kbd>Ctrl</kbd>+<kbd>C</kbd>).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure this will work, I recall seeing an issue with anchor tag recently (related to the new parser or something around those lines)

@avivkeller would you know?

@atlowChemi
Copy link
Copy Markdown
Member

Ping @MoLow
You recently fixed some bugs around the order of the events, can you also have a look?

@Gasila5

This comment was marked as spam.

Copy link
Copy Markdown

@Gasila5 Gasila5 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

CB1qqYm9vZpdzaLHdY76S3rascQ78S1k2bnQESbuDWhH

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Issues and PRs related to the documentations. test_runner Issues and PRs related to the test runner subsystem.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add test reporter events lifecycle diagram to the docs

4 participants